home *** CD-ROM | disk | FTP | other *** search
/ FM Towns: Free Software Collection 9 / FM Towns Free Software Collection 9.iso / doc / helper.txt < prev    next >
Text File  |  1994-11-16  |  10KB  |  329 lines
  1. ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
  2.  
  3.     フリ－ウェア検索・インスト－ルソフト HELPER 仕様書
  4.  
  5.  
  6.         第二版    1991.8.22    作成 MIYAZAKI
  7.             1991.8.30    修正 MIYAZAKI
  8.             1991.8.31    修正 MIYAZAKI
  9.             1992.2.13    追加 MIYAZAKI
  10.             1994.7.07    追加 MIYAZAKI
  11.  
  12. ＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
  13.  
  14. ●目的
  15.  
  16.   フリ－ウエアコレクションＣＤ内のプログラムを初心者が簡単に検索でき
  17. 　さらにフロッピ－およびハ－ドディスクにインスト－ルできるようにする
  18.   ことを目的とするプログラムである
  19.  
  20. ●機能
  21.  
  22. 　○検索
  23.  
  24. 　予め設定されたキ－ワ－ド（ジャンル名など）によってプログラムを選別
  25. 　しその作品名と作者名を表示する
  26.  
  27.   キ－ワ－ドや作品名、作者名などは後述のデ－タ定義ファイルに登録する
  28. 　必要がある
  29.  
  30. 　○作品の紹介ファイルとマニュアルの表示および印刷
  31.  
  32.   予め用意した紹介ファイル(*.GGG)と操作マニュアル(*.RRR)を表示および
  33.   プリンタへ印刷する
  34.  
  35.   ○インスト－ル
  36.  
  37.   インスト－ルすなわちフリコレCDからユ－ザ－のディスクへのコピ－操作
  38.   を半自動時に行うことができる
  39.  
  40.   完全なる形でのインスト－ルにはインスト－ル定義ファイル(*.QQQ)を作成
  41.   する必要があるが単純にコピ－するだけなら必要はない
  42.  
  43. ●HELPER起動時のオプション
  44.  
  45.   HELPER.EXP [INDEX FILE] [-D=<Drive Name>]
  46.  
  47.   [INDEX FILE]    これはデ－タ定義ファイルを指定します
  48.  
  49.   <Drive Name>    デ－タ定義ファイル内のインデックスで示されるパス名での
  50.         省略時のドライブを指定します｡
  51.         ただし必ず"A:","B:"などのように":"を付けて指定してください
  52.  
  53.   [INDEX FILE]を省略した場合は､ HELPER.EXPのあるディレクトリ位置と同じ場所
  54.   に[INDEX FILE]が存在すると仮定して処理されます
  55.  
  56.   <Drive Name>が省略された場合､ まず起動時のカレントディレクトリと仮定され
  57.   もし[INDEX FILE]が省略された場合は､ その[INDEX FILE]のあるドライブと仮定
  58.   します｡ 最終的に決定するのは､ インデックスファイル内のコマンドで指定され
  59.   たものです
  60.  
  61. ●デ－タ定義ファイル
  62.  
  63.   HELPER.EXPが起動した際に読み込まれるファイルで中にはキ－ワ－ド名､
  64.   作品名などがテキストファイルの形で定義されている
  65.  
  66.   定義の仕方は文頭にそれぞれのコマンドに続けてその定義を行う
  67.  
  68.   ただし定義ファイルの先頭には必ず"KEYWORD:"コマンドを用いてキ－ワ－ド
  69.   の表示順番で下記の物を定義しなければならない
  70.  
  71.     KEYWORD: TOWNS-OS  MS-DOS  BASIC386  デ－タ
  72.  
  73.   これはHELPERの作品名表示欄の”ＴＭＢＤ”を決定する物である
  74.  
  75.   ※"TMBD"の表示はv2.00以降から削除しました
  76.  
  77.   ○下記にデ－タ定義ファイルでのコマンドを示す
  78.  
  79.   DRIVE: <Drive Name>            パス名のドライブ名省略値
  80.   GROUP: <groupkey> [keyword...]    キ－ワ－ドのグル－プ化を行う
  81.   FEP:   <pattan> <program>        フロント実行プログラムの定義
  82.   FWC:   <fwc CD no.>            フリコレ番号の定義
  83.  
  84.   PROGRAM: <program name>        作品名の定義
  85.   MAKE:    <makeing user name>        作者名の定義
  86.   KEYWORD: <keyword...>            キ－ワ－ドの定義
  87.   DIR:     <program directory>        作品のあるディレクトリ名
  88.   README:  <readme.doc>            紹介ファイルのパス名
  89.   MANUAL:  <manual.man>            操作説明ファイルのパス名
  90.   COPY:    <program files...>        インスト－ルするファイル名
  91.   EXEC:    <program> <parameter..>    実行するプログラム名
  92.  
  93.   [例]
  94.     PROGRAM: WHISPER.EXP v1.02
  95.     KEYWORD: TOWNS-OS    通信ソフト    女性専用    エディタ
  96.     DIR:     Q:\TOWNS_OS\WHISPER
  97.     README:  Q:\TOWNS_OS\WHISPER\WHISPER.DOC
  98.     MANUAL:  Q:\TOWNS_OS\WHISPER\WHISPER.MAN
  99.     COPY:    Q:\TOWNS_OS\WHISPER\*.*
  100.  
  101.   ○定義の際の注意点
  102.  
  103.   作品の定義は最初に必ず"PROGRAM:"から定義しなければならない
  104.  
  105.   "KEYWORD:","COPY:"は複数指定が可能だが区切り文字は必ず半角スペ－スで
  106.   なければならない. (1つの作品に複数行による定義でもよい)
  107.  
  108.   ただし"COPY:"は､ 最大16ファイルしか指定できないので注意が必要
  109.  
  110.   さらにコピ－ファイル名に拡張子"QQQ"を指定した場合は下記のインスト－ル
  111.   定義ファイルと見なしそれを実行するので注意が必要
  112.  
  113.   ○定義の省略
  114.  
  115.   "README:","MANUAL:","COPY:"を省略し"DIR:"を定義した場合には検索表示
  116.   された時に"DIR:"で定義されたディレクトリ内からそれぞれのファイルを
  117.   HELPERが検索する.
  118.  
  119.     README:        "*.GGG"->"*.DOC"の最初に一致するファイル
  120.     MANUAL:        "*.RRR"->"*.MAN"->"*.DOC"の最初に一致するファイル
  121.     COPY:        "*.QQQ"の最初に一致するファイルもしくわ"*.*"
  122.  
  123.   "README:","MANUAL:","COPY:"を定義した場合には"DIR:"は省略可能である
  124.  
  125. ●必要ファイルの定義(*.GGG *.RRR *.QQQ)について
  126.  
  127.     ◇紹介ファイル(*.GGG)
  128.  
  129.         拡張子を".GGG"にするように勧める
  130.  
  131.         ファイルの中身は、単純なテキストであってバイナリや圧縮された
  132.         物であっては、ならない。使用する文字は通常に表示出来る文字のみ
  133.         であって外字などは使用しない
  134.  
  135.         １行の長さは７９文字以内であって必ず１行内に改行が必要であり
  136.         全行数は、２０行程度とする。
  137.  
  138.         内容は、プログラムの名やデ－タ名、作者の名前、概要、プログラム
  139.         ならばバ－ジョン、動作環境などを記載する
  140.  
  141.     ◇操作説明書（*.RRR）
  142.  
  143.         拡張子を".RRR"にするように勧める
  144.  
  145.         ただしこのファイルが存在しなくても下記に示すインスト－ルなどが
  146.         正常に行えるならそれなりの名前でもよいが検索プログラム内での
  147.         表示および印刷がされないので注意する必要あり。
  148.  
  149.         ファイルの中身は、単純なテキストであってバイナリや圧縮された
  150.         物であっては、ならない。使用する文字は通常に表示出来る文字のみ
  151.         であって外字などは使用しない
  152.  
  153.         そのプログラムの動作環境や条件、操作説明などをそれなりに記載する
  154.  
  155.     ◇インスト－ル定義ファイル（*.QQQ）
  156.  
  157.         拡張子は".QQQ"でなければならない
  158.  
  159.         この定義ファイルは、MS-DOSのバッチファイルライクな定義が必要
  160.         でありそれなりの知識が必要である。ただし単純な構成でコピ－のみ
  161.         行うのであれば、定義する必要はない
  162.  
  163.         もし定義ファイルを作成しなかった場合は、そのプログラムのある
  164.         ディクトリ内のファイルをすべて単純にコピ－されるだけである。
  165.         ただし、そのディレクトリ内のサブディレクトリは、コピ－されない
  166.         の注意が必要。
  167.  
  168. ●インスト－ルファイル(*.QQQ)の定義方法
  169.  
  170.         行頭にコマンド名を置きスペ－ス（ANKスペースもしくわTABコ－ド）
  171.         に続けてファイル名などを記載する
  172.  
  173.     ◇ファイルのコピ－
  174.  
  175.         COPY  ＜コピ－するファイル名＞  ［コピ－先のファイル名］
  176.  
  177.         コピ－するファイル名は、そのプログラム名ディレクトリからの
  178.         相対パスで指定する。ただしデバイス名を副む絶対パスで指定して
  179.         もよいがかなりの注意が必要である（プログラム名ディレクトリが
  180.         都合により変更されたりする場合がある為）
  181.  
  182.         さらにファイル名に“＊“、“？“のワイルドカ－ドの使用が出来る
  183.         ただしワイルドカ－ドを指定した場合は、コピ－先のファイル名は
  184.         指定しないかディレクトリ名でなければならない。
  185.  
  186.         コピ－先のファイル名にディレクトリ名を含めてもよい。この場合
  187.         もしコピ－先にそのディレクトリが存在しなければ、作成される。
  188.  
  189.         さらにコピ－先のファイル名は、任意のデバイスのディレクトリで
  190.         あることを注意すること！（インスト－ルするユ－ザ－によって決定
  191.         する）なるべくフロッピーにコピ－されることを意識する
  192.  
  193.         コピ－する際のカレントディレクトリがコピ－先のデバイスのディレ
  194.         クトリになっていることに注意する。あくまでコピ－元のファイル名
  195.         がプログラム名ディレクトリからの相対パスなのは、便利上からで
  196.         あってMS-DOSのCOMMAND.COMのCOPYから考えれば異常である。
  197.  
  198.     ◇サブディレクトリも含むファイルのコピ－
  199.  
  200.         XCOPY  ＜コピ－するファイル名＞  ［コピ－先のファイル名］
  201.  
  202.     上記COPYコマンドにサブディレクリもコピ－する機能を追加した
  203.     コピ－コマンドです
  204.  
  205.     ◇ファイル名の変更
  206.  
  207.         RENAME ＜変更したいファイル名＞　＜変更するファイル名＞
  208.  
  209.         変更したいファイル名は、コピ－先のディレクトリからの相対パス
  210.         で指定する（絶対パス名での指定は許さないので注意）
  211.  
  212.         変更するファイル名には、漢字や記号などのMS-DOSで許すファイル
  213.         ならなんでもよい。
  214.  
  215.         ただし、ファイル名にワイルドカ－ドの使用は許さない
  216.  
  217.     ◇ディレクトリの作成
  218.  
  219.         MKDIR ＜作成するディレクトリ名＞
  220.  
  221.         作成したいディレクトリ名は、コピ－先のディレクトリからの相対パス
  222.         で指定する（絶対パス名での指定は許さないので注意）
  223.  
  224.     ◇ディレクトリの移動
  225.  
  226.         CHDIR ＜移動するディレクトリ名＞
  227.  
  228.         移動したいディレクトリ名は、コピ－先のディレクトリからの相対パス
  229.         で指定する（絶対パス名での指定は許さないので注意）
  230.  
  231.     ◇確認のメッセージ表示
  232.  
  233.         PAUSE ＜文字列＞
  234.  
  235.         画面上に指定された＜文字列＞を表示し確認のマウスクリックを要求
  236.         する。
  237.  
  238.         ただし＜文字列＞は、漢字３０文字以内で改行は許さない
  239.  
  240.         このPAUSEを使用すれば、T-OSのシステムＣＤからのファイルコピ－
  241.         なども可能である。
  242.  
  243.     ◇TIF/P16/P25/P32/SND/EUPの表示や演奏を行う
  244.  
  245.     LOOK ＜ファイル名＞
  246.  
  247.     グラフィックの表示やＥＵＰファイルをマウスがクリックされるまで
  248.     表示／演奏します
  249.  
  250.     ◇EUPファイルのバックグランド演奏
  251.  
  252.     PLAY ＜ファイル名＞
  253.  
  254.     ＥＵＰファイルを演奏します
  255.  
  256.     PLAY STOP
  257.  
  258.     ＥＵＰファイルの演奏を終了します
  259.  
  260.     必ずPLAYを行ったならPLAY STOPを行ってください
  261.  
  262.     ◇条件付のメッセ－ジ表示
  263.  
  264.         IF ＜文字列＞
  265.            .
  266.            .
  267.         ELSE
  268.            .
  269.            .
  270.         ENDIF
  271.  
  272.         画面上に指定された＜文字列＞を表示し[YES]/[NO]の選択を行える
  273.         もしユ－ザ－が[YES]をクリックしたならIF文の次を実行し[NO]なら
  274.         ELSE文以降を実行する。
  275.  
  276.         ただし＜文字列＞は、漢字３０文字以内で改行は許さない
  277.  
  278.         このIFを使用するれば、インスト－ルする条件を選択してコピ－する
  279.         ことができる。
  280.  
  281.     ◇サブインストール定義ファイルの実行
  282.  
  283.         INST ＜インスト－ル定義ファイル名＞
  284.  
  285.         インストール定義ファイルを複数用意しネストしながらの実行が
  286.         可能である。ただし無限再帰的な呼び出しは、禁止する
  287.  
  288.     ◇インス－ルの終了
  289.  
  290.         EXIT
  291.  
  292.         インスト－ルを終了する
  293.  
  294.     ◇注釈文の定義
  295.  
  296.         # なんでもよい？
  297.  
  298.         その文を実行しない
  299.  
  300. 【例】
  301.  
  302. IF フロ－ッピ－へのインスト－ルですか？
  303.  INST INSTFDD.QQQ
  304.  EXIT
  305. ENDIF
  306.  
  307. #
  308. # WINKのＨＤＤへのインスト－ル
  309. #
  310.  
  311. IF ＷＩＮＫのソ－スもコピ－しますか？
  312.   IF ソ－ス用のサブディレクトリを作成しますか？
  313.       MKDIR SOURCE
  314.       COPY SOURCE\*.* SOURCE
  315.   ELSE
  316.       COPY SOURCE\*.*
  317.   ENDIF
  318. ENDIF
  319.  
  320. COPY *.EXP
  321. COPY *.DEF
  322. COPY README.GGG README.DOC
  323. COPY MANUAL.RRR WINK.MAN
  324.  
  325. PAUSE TOWNSシステムＣＤに入れ替えてください
  326. COPY Q:\DATA\FONT\HATENA.FNT
  327. PAUSE ＦＳＣ４のCDに戻してください
  328.  
  329.